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"KWM Commands" section of this supplement contains commands which have been modified or added. 


Introduction 


The KWW-series of radio modems contains the AX.25 protocol found in the KPC-series modems plus other protocols that have 
the potential to be easily integrated into a variety of commercial applications. 


AX.25 protocol operation is described in the KPC-series manuals along with the AX.25 commands used and cabling/installation 
instructions and other information. 


Although AX.25 packet is a very robust protocol and assures near error-free exchange of data between Data Terminal Equipment 
(DTE) devices, it is somewhat cumbersome to implement. AX.25 requires that the user learn a highly-structured command set and 
the myriad of responses that can be received from the modem. Often, a long process of trial and error results in the realization 
that AX.25 may not be the most suitable protocol to use for a particular application. 


Kantronics has developed the Transparent Unproto Packet (TUP) Mode, Poll Mode, Line Substitution (LINESUB) Mode, and 
Modem Mode protocols for the KWM-series in an effort to allow the modems to be more easily used with different types of 
installations. This manual supplement contains a detailed description of these protocols and their operation. 


Setting up the Modem 


Follow the instructions in the KPC-series manual to properly power and cable the modem to your computer. How to install an 
address (call sign) and set the serial port baud rate for communications between your computer and the modem is explained in 
the "Getting Started" section. The exercise of connecting to your personal mailbox will assure you that the computer is properly 
communicating and the modem is properly responding to command input. 


Bench Test Set-up 


The ideal bench set-up for testing the suitability of the operational characteristics of the selected modem protocol for an 
application is a pair of computer/modem "stations" with the modems cabled back-to-back. To set up the back-to-back "stations," 
connect the transmit audio of the first modem to the receive audio of the second modem and then connect the transmit audio from 
the second modem to the receive audio of the first. A common ground connection is also necessary to provide a return path for 
the audio signals. This allows the modems to communicate with each other using the "wire radio" just described. This preliminary 
step allows experimentation with the modems and the different protocol delays, responses, and characteristics without having to 
be concerned with an actual radio link. 


After the proper protocol has been selected for a particular application, and has been demonstrated to work properly, the radios 
can be integrated into the test set-up. (See KPC-series manual for cabling information.) If problems appear at this stage, the radio 
link is probably at fault. The addition of the radio link will also add a significant amount of time to the data transfer because of 
transmitter key-up and return to receive delays which may require modification of initial parameter settings. Be sure that the 
application can tolerate the additional time that is required for the radio link! 


Protocol Descriptions and Operation 
Transparent Unproto Packet (TUP) Mode 


TUP Mode Description 


The TUP mode protocol utilizes the Unproto mode of the AX.25 protocol, allowing digipeaters (VIA path specified with UNPROTO 
command) to be used in order to effectively extend the range of a radio data system beyond simplex distance. This protocol uses 
the standard AX.25 CRC-16 error-checking to provide a high degree of data integrity. Data is sent and received in a totally 
transparent fashion, allowing all ASCII characters to be utilized (hex 00 through hex FF). Radio transmission is based on the 
PACTIME AFTER parameter setting of the modem, the setting of the carrier detect method, and the settings of the slot and persist 
channel access algorithm. Any data that is received by the modem via the radio is output to the serial port only if it contains no 
detectable errors. The received data will be exactly the same as the data that was sent to the input serial port of the transmitting 
mode, without any address headers or added formatting of the data. The modem is capable of selectively filtering monitored data 
from or to different modem addresses using the BUDLIST command. 


If digipeaters must be used to extend the range of the system, the information frame sent by any modems in the system will be 
output to the serial ports of the receiving modems only once, regardless of how many times it was received correctly. Also, data 
sent by any modem will not be decoded by itself when the data is digipeated. The TUP mode protocol provides an automatic 
"Time to Live" timer that inhibits any modem from transmitting or receiving additional data until sufficient time has expired to allow 
in-progress data to travel through all the digipeaters specified in the UNPROTO field of the originating modem. Since the time for 
a given packet to travel the entire UNPROTO path may vary due to the presence of other signals or noise, TUPTIME is used to 
impose an additional delay time, if needed, during which each modem will be inhibited from decoding or transmitting new data. 
This setting can be determined experimentally. It is important to note that TUPTIME applies only to the receiving modems and 
should be set to the same value at all sites. It is the responsibility of the host system to insure that additional data is not 
transmitted until sufficient time has elapsed to allow data to travel to the last digipeater and the response, if any, to travel back to 
the host. Note that the automatic "Time to Live" timer and the TUPTIME timer are only in effect if packets are being digipeated. 


TUP Mode Operation 


Commands Used 
Basic TUP Operation involves just a few commands: 


MYCALL - The MYCALL command determines the MODEM address. This must be entered after the autobaud routine has 
detected an asterisk (*). 


TXDELAY - The TXDELAY (TXD) command determines how long the modem will assert the Push-to- Talk line of the radio before 
sending data. This time will have to be determined experimentally since it will vary from radio to radio. If the TXD is set too short, 
the data transmitted will not be received by other units in the system. Setting TXD too long will reduce channel capacity. NOTE: 
Since TXD is used in the computation of the automatic timer used to inhibit transmission until a digipeated packet has had time to 
reach its destination, TXD must be set to the same value in all modems in the system 


PACTIME - The PACTIME parameter determines how long the modem will wait after receiving data to be transmitted from the 
DTE before beginning the radio key-up sequence. Normally, this parameter should be set to AFTER 1 (100 ms) in order to 
minimize "dead air" time on the system. 


PACLEN - PACLEN sets the maximum size of the data packet(s). Most applications do not require large amounts of data to be 
transferred so the default value (128) will probably be satisfactory, allowing packets up to 128 bytes. If the amount of data to be 
sent exceeds the PACLEN parameter setting, the transmission will be composed of multiple packets containing the data. 


PERSIST and SLOTTIME - These parameters determine how aggressively the modem will attempt to access a multi-user channel 
based on carrier detect. See KPC-series manual for a full explanation of these parameters. 


Entering TUP Mode 
Use the INTFACE command to begin TUP operation. Set the INTFACE command to TUP: 
cmd:INTFACE TUP <cr> 
and turn the unit off and then back on. 
Exiting TUP Mode 
If you want to exit the TUP mode to "fine tune" parameter settings (or for any other reason), the Command mode of the modem 


can be regained by using the transparent data escape sequence, i.e., by sending a series of three control-Cs (unless a different 
control character for COMMAND has been defined). (See TRANS command in the Reference manual). 


Poll Mode 


Poll Mode Protocol Description 


The POLL mode is generally used in system applications that implement a polled-response protocol between a central site 
(Control Site) and one or more remote locations (Remote Site). The POLL mode is similar to the TUP mode since it uses a data 
transparent broadcast mode and a packet protocol with CRC-16 error-checking to insure the integrity of the received data. All 
ASCII characters (hex 00 through FF) can be transmitted and received. The POLL mode differs from TUP mode by allowing an 
application program to address specific locations without changing any modem parameters. All data sent by the application 
program at the central sit must begin with the address (POLLID) of the intended remote modem. When any remote modem 
receives data from the radio, the data is checked for errors and the received POLLID is compared with its own POLLID. If they 
match, the POLLID is stripped and the data that follows is sent to the serial port. All data received by the central site from the 
remote location will arrive with the POLLID of the remote site automatically attached to the beginning of the data. 


It is the responsibility of the application program to: (1) address data to be sent to the remote sites, (2) determine if the data was 
received, and (3) recognize responses that contain the remote site's POLLID and data. Digipeating is not allowed 


Poll Mode Operation 


Commands Used 
Each modem is set up differently depending upon whether it is to be a Control modem or a Remote modem. 
Control Site 


Control Site Configuration - The POLLID command in the Control modem must be set to 0000 and the 
INTFACE command must be set to POLL. (See "Entering POLL Mode" below.) 


Control Site Transmit Format - All data sent to the Control modem via the RS-232 serial port must begin with a 
POLLID (four digit remote address between 0001-9999) and be followed immediately by the poll data. The data 
sent by the application to the Control modem must contain less than PACLEN bytes. If the poll data contains 
more characters than allowed by the setting of the PACLEN command, the data will be fragmented and multiple 
packets will be formed and transmitted by the modem. These additional packets will contain only the balance of 
the data received by the modem. Since these packets do not begin with a POLLID, they will be ignored by all 
Remote modems. 


Control Site Receive Format - All Remote transmissions received by the Control modem shall consist of the 
Remote POLLID followed immediately by the Remote data. Both POLLID and data will be sent to the control DTE 
via the RS-232 port. 


Remote Site 


Remote Site Configuration - The POLLID command in each of the Remote modems must be set to a different 
number between 0001 and 9999. This assures that data is received by just one remote device. 


The INTFACE command in each modem must be set to POLL. (See "Entering POLL Mode" below.) 


Remote Site Transmit Format - Remote sites generally do not have much computing capacity. . Therefore, the 
transmitted format of the data is, of necessity, straightforward. All data recelved via the serial port will be formed 
into packets and transmitted with the address (POLLID) attached to the beginning of each data packet. 


Remote Site Receive Format - All data received by the Remote via the radio is first examined for errors using a 
CRC-16 error-checking algorithm. Data packets that contain errors are discarded. If the data contains no errors, it 
is then checked for a match of the received POLLID and its own POLLID. If there is not a match, the data is 
discarded. If there is a match, the POLLID is stripped and the raw data is passed to the RS-232 serial port for 
processing. The received data format will be exactly the same as the data sent to the Control Modem by the 
application program. 


The CONMODE parameter affects when data will be sent in Poll Mode. 
If CONMODE is set to CONYERS (default), data will be transmitted when any of the following conditions is met: 


1. The SENDPAC character is received by the modem. The default SENDPAC character is a carriage return 
and can be changed to suit an existing application. The SENDPAC character can be either stripped or 
appended to the data by setting the CR command ON to append, or OFF to strip. 


2. PACLEN is exceeded. CAUTION: MASTER (Control Site) operation will be unusable if PACLENis 
exceeded since each packet of data sent MUST begin with a Slave (Remote Site) POLLID (0001-9999). 
Remote transmission may exceed the setting of PACLEN since each packet transmitted from the Remote 
will contain the proper POLLID. If fragmentation of data occurs, the application program is responsible for 
reconstructing the data. PACLEN determines the maximum size of data packets (default 128 characters). 
Normally, the amount of data to be transmitted will be considerably less than this. 


3. CPACTIME is on and PACTIME expires. If CPACTIME is ON, data will be periodically transmitted based 
on PACTIME timeout. 


If CONMODE is set to TRANS, data will be transmitted when: 

1. PACLEN is exceeded, or 

2. PACTIME expires. 

Suggested Settings 
Usually, the CONMODEcommand is set to TRANS and the PACTIME command is set to AFTER 1. The 
CONMODE TRANS command makes the modem data transparent to the Remote device. The PACTIME AFTER 
1 command allows the modem to transmit the data received via the serial port with as little delay as possible. This 
speeds up the response time of the system by reducing "dead-air" time. 
It is also recommended to set the PACLEN command to zero. This allows the modem to send a single packet of 
data to the radio of any size between 1 and the maximum of 256 characters. If the response data from the remote 
contains more characters than the PACLEN command allows, the data will be transmitted in multiple packets with 
the Remote POLLID automatically attached to the beginning cfeach data packet. In such a case, it is the 
responsibility of the Control Application Program to reassemble the data. 
CAUTION: Allowing the Control Site application to send more data than that permitted by the PACLEN command 
is the most common cause of failure using the POLL mode. BE ABSOLUTELY SURE THAT CONTROL SITE 
TRANSMISSIONS NEVER EXCEED THE PACLEN LIMIT! 
Entering POLL Mode 


When you have entered the POLLID of the unit and made any desired changes from the default settings in the parameters, use 
the INTFACE command to begin POLL operation. Set the INTFACE command to POLL: 


cemd:INTFACE POLL <cr> 
and turn the unit off and then back on. 
Exiting POLL Mode 


If you want to exit POLL mode to "fine tune" parameter settings (or for any other reasons), the command mode of the modem can 
be regained as follows: 


If CONMODE = CONV 
Enter: OOOOQUIT<cr> (NOTE: MUST BE IN UPPER CASE) 
If CONMODE = TRANS 


Use the transparent data escape sequence, i.e., send a series of three control-Cs (unless a different control 
character has been defined). (See TRANS command in the Reference Manual). 
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Line Substitution (LINE SUB) Mode 


LINE SUB Mode Protocol Description 


The LSUB mode of operation provides a method of transmitting-and receiving raw ASCII data via a radio. Data is sent and 
received in a totally transparent fashion, allowing all ASCII characters to be utilized (hex 00 through hex FF). There is no 
addressing, error-detection or automatic retransmission of the data. When the receiving modem detects the proper Start-of-Data 
sequence generated by the transmitting modem, it will output the data that follows to its; serial port. At the end of the received 
data there is an End-of-Data sequence that permits the receiving modem to recognize the end of the data and quit translating the 
receiver audio. This allows the modems to operate with open squelch audio from the radios. Since the protocol constitutes a very 
small portion of the transmission, the effective data throughput is very nearly that of the radio baud rate (HBAUD). 


LSUB Mode Operation 


Commands Used 
TXDELAY - The TXDELAY (TXD) command determines how long the modem must key the Push-to-Talk line of the radio before 
sending data. This time will have to be determined experimentally since it will vary from radio to radio. If the TXD is set too short, 


the data transmitted will be garbled and not received by other units in the system. Setting TXD too long will reduce channel 
capacity. 

PACTIME - The PACTIME parameter determines how long the modem will wait after receiving data to be transmitted from the 
DTE before beginning the radio key-up sequence. Normally, this parameter should be set to AFTER 1 (100 ms.) in order to 
minimize "dead-air" time on the system. 


PERSIST and SLOTTIME - These parameters determine how aggressively the modem will attempt to access a multi-user channel 
based on carrier detect. See KPC-series manual for a full explanation of these parameters. 


Entering LSUB Mode 


When you have made any desired changes from the default settings for the above parameters, use the INTFACE command to 
begin LSUB operation. Set the INTFACE command to LINESUB: 


cmd:INTFACE LINESUB <cr> 
and turn the unit off and then back on. Be aware that there is no data flow control. 
Exiting LSUB Mode 
If you want to exit LSUB mode to “fine tune" parameter settings (or for any other reason), the Command mode of the modem can 


be regained by using the transparent data escape sequence, i.e., by sending a series of three control-Cs (unless a different 
control character has been defined). (See TRANS command in the Reference Manual). 


Modem Mode 


Modem Mode Protocol Description 


It is important to note that when the MODEM mode is used, the modem is acting as a pure modulator/demodulator and uses the 
RTS and CTS lines of the serial port to control transmission of the data. There is no addressing, error correction, error detection, 
or flow control of the data as it us transmitted or received. The audio tones generated and received by the modem will directly 
mimic the data in composition and speed. Because of this, it is essential that all Data Terminal Equipment (DTE) associated with 
this mode have identical serial port parameters in use. 


EXAMPLE: 1200 baud, No parity, 8 data bits, 1 stop bit 


Modem Mode Operation 


Commands Used 


The TXDELAY (TXD) command sets the parameter to control the time necessary (in 10 ms steps) for the transmitter to be keyed 
prior to transmitting data tones. TXD is the only command in the manual that affects the MODEM mode of operation. This timing 
interval can be adjusted to suit a particular radio by changing the value of the TXD parameter. 


Entering MODEM Mode 


When you have set the TXD parameter as desired, use the INTFACE command to begin MODEM operation. Set the INTFACE 
command to MODEM: 


cmd:INT MODEM <cr> 
Turn the unit OFF and then back ON with RTS held low. 


The idle state of the CTS and RTS lines between the DTE and the modem is normally low (negative voltage). When the RTS line 
is asserted by the DTE, the modem will immediately key the transmitter, sending a "Mark Hold" tone and return CTS to the DTE 
after the TXDELAY (TXD) time period has expired. The return of CTS indicates to the DTE that the radio is transmitting and that 
the modem is ready to accept data via the serial port at any speed up to 1200 baud. Releasing the RTS signal from the DTE to 
the modem will cause the modem to release the Push-To-Talk line to the radio and drop the CTS to the DTE. 


Exiting MODEM Mode 


Since all data appearing on the serial input to the modem is regarded as data to be sent, the Command mode of the modem 
cannot be regained by using the transparent data escape sequence, i.e., by sending a series of three control-Cs as described in 
the TRANS command in the Reference manual. If you wish to exit MODEM mode to change the TXD parameter (or for any other 
reason), holding the RTS line high during power-up will restore the unit to the Command mode. 


KWM Commands 


This section contains only those commands which have been added or modified for use with the KWM-1200 Plus. All other 
commands are found in the command section in the KPC-3 Plus Reference manual or addenda. 


Added Commands 


POllid 0000-9999 {default 0000} 

Pollid is used with the Poll Mode. The four-digit POLLID determines if the modem is a Control or a Remote modem. If the 
modem is a Remote, POLLID also sets the Remote address. If POLLID is equal to 0000, the modem is a Control Modem. 
If POLLID is 0001 to 9999, the modem is a Remote Modem. 

TUptime n (n = 0 - 225) {default 1} 


TUPTIME is used only in TUP mode and imposes an additional time to live (in 100 ms increments) for digipeated packets. 
Modified Commands 


INtface Terminal | KISS | XKISS | HOST | GPS | LINESUB | MODEM|TUP|POLL {default TERMINAL} 


The TUP, POLL, LINESUB (LSUB), and MODEM modes have been added to the INTFACE command for the KWM-1200 
Plus. NEWUSER has been deleted from the KWM firmware. 
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